home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / hemm.z / hemm
Encoding:
Text File  |  2002-10-03  |  5.9 KB  |  135 lines
  1. HEMM(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      CCHHEEMMMM, ZZHHEEMMMM - Multiplies a complex general matrix by a complex
  6.      Hermitian matrix
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Complex
  10.  
  11.         CCAALLLL CCHHEEMMMM ((_s_i_d_e,, _u_p_l_o,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b,, _b_e_t_a,, _c,, _l_d_c))
  12.  
  13.      Double complex
  14.  
  15.         CCAALLLL ZZHHEEMMMM ((_s_i_d_e,, _u_p_l_o,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b,, _b_e_t_a,, _c,, _l_d_c))
  16.  
  17. IIMMPPLLEEMMEENNTTAATTIIOONN
  18.      IRIX systems
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.      These routines multiply a complex general matrix by a complex
  22.      Hermitian matrix. They perform one of the following matrix-matrix
  23.      operations:
  24.  
  25.           _C  <-  _a_l_p_h_a _A_B + _b_e_t_a _C
  26.  
  27.           _C  <- _a_l_p_h_a _B_A + _b_e_t_a _C
  28.      where _a_l_p_h_a and _b_e_t_a are scalars, _A is a Hermitian matrix, and _B and _C
  29.      are _m-by-_n matrices.
  30.  
  31.      These routines have the following arguments:
  32.  
  33.      _s_i_d_e      Character*1.  (input)
  34.                Specifies whether the Hermitian matrix _A appears on the left
  35.                or right in the operation, as follows:
  36.                _s_i_d_e = 'L' or 'l':  _C <- _a_l_p_h_a _A_B + _b_e_t_a _C
  37.                _s_i_d_e = 'R' or 'r':  _C <- _a_l_p_h_a _B_A + _b_e_t_a _C
  38.  
  39.      _u_p_l_o      Character*1.  (input)
  40.                Specifies whether the upper or lower triangular part of the
  41.                Hermitian matrix _A is referenced, as follows:
  42.  
  43.                _u_p_l_o = 'U' or 'u': only the upper triangular part of the
  44.                Hermitian matrix is referenced.
  45.                _u_p_l_o = 'L' or 'l': only the lower triangular part of the
  46.                Hermitian matrix is referenced.
  47.  
  48.      _m         Integer.  (input)
  49.                Specifies the number of rows in matrix _C.  _m must be >= 0.
  50.  
  51.      _n         Integer.  (input)
  52.                Specifies the number of columns in matrix _C.  _n must be >=
  53.                0.
  54.  
  55.      _a_l_p_h_a     First scalar factor.  (input)
  56.                CCHHEEMMMM: Complex.
  57.                ZZHHEEMMMM: Double complex.
  58.  
  59.      _a         Array of dimension (_l_d_a,_k_a).  (input)
  60.                CCHHEEMMMM: Complex array.
  61.                ZZHHEEMMMM: Double complex array.
  62.  
  63.                Contains matrix _A.  When _s_i_d_e = 'L' or 'l', _k_a is _m;
  64.                otherwise, it is _n.
  65.  
  66.                Before entry with _s_i_d_e = 'L' or 'l', the _m-by-_m part of
  67.                array _a must contain the Hermitian matrix, such that:
  68.  
  69.                * If _u_p_l_o = 'U' or 'u', the leading _m-by-_m upper triangular
  70.                  part of array _a must contain the upper triangular part of
  71.                  the Hermitian matrix.  The strictly lower triangular part
  72.                  of _a is not referenced.
  73.  
  74.                * If _u_p_l_o = 'L' or 'l', the leading _m-by-_m lower triangular
  75.                  part of array _a must contain the lower triangular part of
  76.                  the Hermitian matrix.  The strictly upper triangular part
  77.                  of _a is not referenced.
  78.  
  79.                Before entry with _s_i_d_e = 'R' or 'r', the _n-by-_n part of
  80.                array _a must contain the Hermitian matrix, such that:
  81.  
  82.                * If _u_p_l_o = 'U' or 'u', the leading _n-by-_n upper triangular
  83.                  part of array _a must contain the upper triangular part of
  84.                  the Hermitian matrix.  The strictly lower triangular part
  85.                  of _a is not referenced.
  86.  
  87.                * If _u_p_l_o = 'L' or 'l', the leading _n-by-_n lower triangular
  88.                  part of array _a must contain the lower triangular part of
  89.                  the Hermitian matrix.  The strictly upper triangular part
  90.                  of _a is not referenced.
  91.  
  92.                The imaginary parts of the diagonal elements need not be
  93.                set.  They are assumed to be 0.
  94.  
  95.      _l_d_a       Integer.  (input)
  96.                Specifies the first dimension of _a as declared in the
  97.                calling program.  When _s_i_d_e = 'L' or 'l', _l_d_a >= MMAAXX(1,_m);
  98.                otherwise, _l_d_a >= MMAAXX(1,_n).
  99.  
  100.      _b         Array of dimension (_l_d_b,_n).  (input)
  101.                CCHHEEMMMM: Complex array.
  102.                ZZHHEEMMMM: Double complex array.
  103.                Contains matrix _B.  Before entry, the leading _m-by-_n part of
  104.                array _b must contain matrix _B.
  105.  
  106.      _l_d_b       Integer.  (input)
  107.                Specifies the first dimension of _b as declared in the
  108.                calling program.  _l_d_b >= MMAAXX(1,_m).
  109.  
  110.      _b_e_t_a      Second scalar factor.  (input)
  111.                CCHHEEMMMM: Complex.
  112.                ZZHHEEMMMM: Double complex.
  113.                When _b_e_t_a is supplied as 0, _c need not be set on input.
  114.  
  115.      _c         Array of dimension (_l_d_c,_n).  (input and output)
  116.                CCHHEEMMMM: Complex array.
  117.                ZZHHEEMMMM: Double complex array.
  118.                Contains matrix _C.  Before entry, the leading _m-by-_n part of
  119.                array _c must contain matrix _C, except when _b_e_t_a is 0; in
  120.                which case, _c need not be set.  On exit, the _m-by-_n updated
  121.                matrix overwrites array _c.
  122.  
  123.      _l_d_c       Integer.  (input)
  124.                Specifies the first dimension of _c as declared in the
  125.                calling program.  _l_d_c >= MMAAXX(1,_m).
  126.  
  127. NNOOTTEESS
  128.      CCHHEEMMMM/ZZHHEEMMMM is a Level 3 Basic Linear Algebra Subprogram (Level 3
  129.      BLAS).
  130.  
  131. SSEEEE AALLSSOO
  132.      SSYYMMMM(3F)
  133.  
  134.      This man page is available only online.
  135.